BBS Toolkit/BBS Toolkit.iso/qbbs/ucvs101c.zip/UCVS.DOC

Text File | 1990-06-12 | 15KB | 383 lines

                   The User CallBack Verification System

                                Version 1.01c

                           Copyright (c) 1990 by

                     New Dimension Software Development

                   A service of New Dimension Enterprises























                         New Dimension Enterprises
                           13012 Centerburg Road
                             Sunbury, Oh  43074
                             FidoNet 1:226/270.1

Welcome to UCVS!

Thank you for trying our User CallBack Verification System.  We hope that
it will become an integral part of your BBS operations.  UCVS 1.0 currently
has the following features:

* RA/QBBS compatible
* Allows you (the SysOp) to define the format of user's phone numbers
* Performs area code checking within the user's phone numbers
* Allows mass phone number reformatting
* Handles local, toll, and long distance calling
* Toll and long distance calls made for verification ONLY
* Bad verifies may be locked out, deleted, or left for investigation
* Performs duplicate phone check and notifies you where the dupe is
* SysOp definable text files for board personalization
* Codeword function for extra security and to prevent script files
* Complete flag and security level support (to 64000)
* Supports multi-line operation using child directories
* Support up to 38.4k baud transmissions with locked or unlocked fossils

We hope you enjoy using UCVS.  If you have any problems or comments
concerning the program or this documentation, coorespondence may be
addressed to Mike Teegarden c/o New Dimension Enterprises at the address
listed on the front page.  Netmail is a quicker way to get a response, but
either method will be handled quickly.



Disclaimer:

This software is distributed as-is with no warranty, either expressed or
implied.  The user assumes all responsibility for his use of this software
and any damages that may occur.  Neither New Dimension Enterprises, nor it's
representatives may be held responsible for any damages that may occur.


Distribution:

This software is hereby released as SHAREWARE.  This means that you can use
the software for a trial period of two weeks.  If at that time you decide
you want to continue to use the program a registration fee of $ 12.00
should be paid.  This registration fee will entitle you to a registration
key which will remove the evaluation notice from the program.  This
software is not crippled in any way.  All parts of the program function
without the key, but the program will notify all your users that it isn't
registered.  This key is good for all future versions of UCVS.


Getting Started:

The UCVS archive should contain the following files:

UCVS.EXE - Main program
UCVS.DOC - This file
UCVSOPEN.TXT - Sample text file (opening screen)
UCVSDUPE.TXT - Displayed if duplicate phone found
UCVSCALL.TXT - Displayed to users who are toll or l/d
UCVSTOLL.TXT - Defines a toll call to the user
UCVSCONN.TXT - Displayed after reconnection with user

The following files are used by UCVS but must be created if used:

UCVS.CFG - The configuration file (The system creates this)
UCVSAC.CTL - Area code exclusion file (Create if used)
UCVSLONG.TXT - Text file displayed if user is calling from restricted A/C

Unzip the archive and place the EXE file in your main BBS directory.  Place
the text files in another directory, preferably your text file directory.
Return to your main BBS directory and enter UCVS /C to invoke the
configuration system.



Configuration:

When the configuration function is first invoked it will inform you that
the configuration file wasn't found and will ask if you want to create it.
Answer Y to create your configuration file.  The screen will then come up
with the default settings.  Change only the ones you want.  If you
accidently press a key that you don't want to change, just press enter to
leave the field as it is.  Here is a brief description of all the
configuration options.

A. BBS Name:  Your BBS name as it is to be registered.  This is what your
key is based on.

B. Dialing Prefix: The dialing command for your modem.  For hayes
compatibles it's either ATDT or ATDP.  Check your modem's manual for the
correct prefix.

C. Dialing Suffix: The command to end the dialing command.  Usually a C/R.
Use the "|" symbol for a C/R.

D. Modem Init: The Init string for your modem.  Note: This should NOT be
ATZ!  The only commands you will need to put here would be to turn off
local echo, the speaker, or auto answer.  If you have your modem configured
for auto answer, use this command shut it off.  Place the "|" at the end if
needed.  If you don't need to init the modem leave the "AT|" command there.
UCVS requires EXTENDED WORD result codes to work properly.  If you don't
have it set before you run UCVS, set it here.

E. Use Data Phone: Determines if the user can use his data phone number as
a choice for the callback.  If set to "N" then the only number a user can
use is the home number.

F. New User Sec: Security level needed for user to access UCVS.  Note: A
local user can ALWAYS access UCVS. (If you have your menus set up that way)

G. Val User Sec: Security level user receives after successful
verification.

H-K. Flags: These determine if any flag settings should be changed.  Use an
"X" to turn a flag ON and a "-" to turn it OFF.  All other characters are
ignored.  The "?" are used for place markers.

L. Call Type: Determines if system will make Local, Toll, or Long Distance
calls.  If the system is setup for L/D calls, then all calls will be made.
Also, if Toll calls are specified, only Local and Toll calls will be made.

M. BBS Type: Defines the type of BBS software being run.  Currently this is
used only for logging purposes.  It determines either QBBS or RA/FD style
logging.

N. Home Mask: The phone number mask for the home phone number.  Define it
as you want.  QBBS users SHOULD leave it as it is because that is the
format QBBS and many QBBS utilities use.  RA users can determine what type
of phone mask to use.  The system only recognizes the "X" character.  Every
"X" encountered in the mask is replaced with the cooresponding number in the
current phone number. Please see the examples at the end of this document.

O. Data Mask: The phone number mask for the data phone.  See above.



Configuration (cont):

P. Text File Dir: Complete path to your text files.  Eg. C:\BBS\TEXT\  The
system will add the ending "\" if you forget.

Q. Users File Dir: Location of USERS.BBS.  Location ONLY.  Eg. C:\BBS\

R. Area Code: Your local area code.  Used to determine local/toll calls
from long distance.  Also asks if you want to verify area codes?  If set to
"Y" and a user enters a phone number without an A/C AND there is room in
the phone number field, the area code will be added to the phone number.
This function is also used in the user phone number reformat option. (See
Reformatting section)

S. Log File: Name and location of your log file.  Eg. C:\BBS\SYSTEM.LOG

T. Check Dupes: If set, the system will check the users phone numbers
against all other phone numbers.  If a duplicate is found the user is
displayed the UCVSDUPE file and returned to the BBS.  The user record
number which contained the dupe is posted in the log file.

U. Toll Format: Allows you to choose which toll format is used in your
calling area.  More than one format may be choosen.  If more than one
format is chosen, the user is prompted for the correct format to use on his
call.  Invalid formats will result in failed verification.

V. Bad Status: Determines what to do with bad verifies.  You can delete,
lockout, or leave the record alone.  This takes effect immediately after
the verification fails.

W. Use Codewords: Extra security function which causes user to enter a
random codeword before entering his password.  If codeword check fails then
verification fails.

X. Register Key: Registration key as sent to you after receipt of your
registration fee.

Y.  Call Times: Times UCVS will allow toll and l/d verifies in 24 hour
format.

After configuring the program to your likes enter "Z" and the config file
will be written to disk.  Now your ready to use UCVS.


Using UCVS:

Using UCVS is very simple.  First create a menu command to access UCVS.  It
can be set up as either a Type 7 or Type 15 menu function.  If setup as a
Type 7 use "UCVS.EXE" in your optional data field.  If setup as a Type 15,
just use "UCVS" in your batch file. QBBS users MUST use a type 15.

When invoked UCVS reads the configuration file, DORINFO1.DEF, and
EXITINFO.BBS.  It then displays "UCVSOPEN.TXT" and prompts for which phone
number to call. (If Use Data Phone is off or if the data phone doesn't
exist, it won't ask which phone to call)

Note: The phone numbers are formatted BEFORE the user sees them.  If for
some reason the phone number is not correct (user didn't enter an area code
and doesn't live in your area, but the system put your area code on his
number) then the user has the chance to stop the process by answering "N"
to the "Is the above info correct" prompt.


Using UCVS (cont)

If the information is correct, the system then determines what type of call
the user is (Local, Toll, or L/D).  If the user's selected number has the
same area code as you have setup in the configuration then the user is
asked if the phone call will be a toll call.  A toll call is defined as a
call in the same area code which requires special dialing instructions such
as dialing a 1 before the number.(Eg. 1-555-1212).  If the user's phone
number is a type which your configuration doesn't permit (user is L/D and
you only accept Local) then the system display the "UCVSCALL.TXT" file and
returns to the BBS.

The system will the check for dupes (if set) and select a codeword (if
set) for the user.  The user then has one last chance to abort the
verification process.  If the user continues with the verification, the
system drops DTR and re-inits the modem.  The system will try three (3)
times to call the user back.  If all three fail, the verification fails and
the user record is dealt with as defined in your configuration.  If a
connection is made, the user has three chances to enter his codeword (if
set) and then three chances to enter his password.  If any of these fail,
the verification fails.  NOTE: The system will try to reconnect at the same
speed the user called in at.  If the system can't get a connect at the same
speed, that call fails.


UCVS Extras:

UCVS has the following SysOp hot keys:

Alt-C - Enter chat mode (ESC to exit)
Alt-H - Hangup user (twit key)
Alt-L - Lockout User

The text files are distributed only as samples.  Feel free to use them in
your system if you like.  If you'd like to change the files or create new
ones, the following control codes will control color displays within the
files.

~a - Blue                  ~i - Lt Blue
~b - Green                 ~j - Lt Green
~c - Cyan                  ~k - Lt Cyan
~d - Red                   ~l - Lt Red
~e - Magenta               ~m - Lt Magenta
~f - Brown                 ~n - Yellow
~g - White                 ~o - High Intensity White
~h - Gray

These codes are replaced with their ansi equivalent and sent to the remote
user.


Area Code Exclusion:

If you are running your system to make L/D calls, you can create a file
called "UCVSAC.CTL" which contains area codes to EXCLUDE from calling.  The
format of this file is simply one area code per line (straight ascii text
file).  If found, the system will scan the list, and if the user's area
code is found, the file "UCVSLONG.TXT" will be displayed and the user will
be returned to the BBS.  Note:  You DO NOT need these two files to run the
system.  They are simply extras to be created if needed.


A note about calls:

The UCVS program is setup to make local calls and upon successful
verification, return the user to the BBS.  Toll and L/D calls are made on a
VERIFY ONLY basis.  Upon a successful verification, the user's info is
updated and the call is cancelled.  If you don't want to bother with Toll
or L/D calls, set your configuration to Local Only.


Phone mask exmples:

Here a few examples of phone mask conversion:

User's phone                  Mask                    Result
------------                  ----                    ------
8005551212                   XXX-XXX-XXXX             800-555-1212
800555-1212                  XXXXX-XXXX               80055-5121
5551212    (no a/c check)    XXX-XXX-XXXX             555-121-2
555-1212   (a/c check)       XXX-XXX-XXXX             AAA-555-1212  AAA=A/C

Note:  Only the numbers are transferred.  If the user placed the "-" in his
phone number, it doesn't matter.  UCVS only worries about the individual
numbers (0-9).


Reformatting:

UCVS also includes a mass phone number reformatting function.  To invoke
this function enter UCVS /F.  Note: This function is immediate.  No double
checking of any kind.  It will use the mask definitions in your config file
and will also perform area code verifying if on.  PLEASE make a backup copy
of your user's file BEFORE using this function.  If there is an incorrect
mask in your configuration, your users' phone numbers WILL be difficult, if
not impossible, to read.  Also note that this function should NOT be run on
a multi-line system if someone is on the system.  If it is, irrepairable
damage to the user file could result.  This should only be used if formats
are changed or to initially format your user file.


Locked baud rates:
UCVS will handle locked baud rates if you specify the baud rate on the
command line in the format /L=.  If you are not running with a locked
fossil then do not use this switch as it will override the users log on
baud rate.  Note that if the /L switch is specified on the command line,
whatever rate is specified will be shown on the status line.  Eg. /L=19200
displays [ 19200 ] on the status line.


Status Line:

The status line contains the follwing information:

User's Name
Where user is calling from
Connected baud rate or [L] for local
[G] if graphics enabled


Registration:

To register your copy of UCVS send $ 12.00 (check or money order) along
with your name, address, a fidonet address (if applicable) and your BBS
name as you have it in field A of your configuration file.  The BBS name
MUST be included to get your key.  Please allow 2 weeks via U.S. mail and 1
week for netmail reply.  Send this information to:

New Dimension Enterprises
re: UCVS Registration
13012 Centerburg Rd.
Sunbury, Oh  43074

Questions and comments can be forwarded to the above address or to Mike
Teegarden at fidonet address 1:226/270.1
                                      ^^
                            Notice the point address